home *** CD-ROM | disk | FTP | other *** search
/ Magnum One / Magnum One (Mid-American Digital) (Disc Manufacturing).iso / d8 / zcomd506.arc / ZCOMMDOC.AD < prev    next >
Text File  |  1991-05-06  |  76KB  |  1,771 lines
  1.  
  2.         Version 17.78 TurboDial 2.35            Universal Line Printer Edition
  3.         ZCOMM User Manual                                                   91
  4.  
  5.         set[c|s] ........................Set string parameters / soft keys
  6.         setn ............................Set string param to Arithmetic
  7.         expression
  8.         set? ............................Set string param to test value
  9.         sleep ...........................Let the world pass by
  10.         source scriptfile ...............Call scriptfile as a subroutine
  11.         split ...........................Split (parse) a string to tokens
  12.         ss ..............................Regular Expression pattern match
  13.         string parse
  14.         trs .............................Translate characters in a string
  15.         wait ............................Wait for pattern(s) in modem data
  16.         while ...........................Looping control
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.         (C) 1990 Omen Tech Inc                         Chapter 17 Special Keys
  59.  
  60.  
  61.         Version 17.78 TurboDial 2.35            Universal Line Printer Edition
  62.         ZCOMM User Manual                                                   92
  63.  
  64.         18.  SPECIAL KEYS
  65.  
  66.         Ctrl-Break clears any typeahead, unlocks the keyboard, and stops
  67.         whatever function[1] ZCOMM is doing in a reasonably orderly manner.[2]
  68.         Ctrl-Break cancels kbdlock.  It is not so abrupt as the NUKE key.  The
  69.         B test condition tests whether Ctrl-Break has been struck since the
  70.         last purgek command.
  71.  
  72.         Keyboarding ALT-N will NUKE (abort) the current command and return to
  73.         ZCOMM's command prompt.[3] If one or more scripts are active, the
  74.         current line number (counting from the first line in the script file)
  75.         for each level of script is displayed.* NUKE will terminate any
  76.         script.  NUKE closes any transmit file, but not a receive capture
  77.         file.  (A receive capture file may be closed with the "close"
  78.         command.) NUKE does not disconnect the modem by dropping DTR.[4]
  79.  
  80.         Keyboarding ALT-Z appends the contents of the display screen to a DOS
  81.         file.  The pathname is contained in the string parameter picture which
  82.         may be changed with the set command.  The exact contents of the screen
  83.         memory are written to the file, with each screen character followed by
  84.         its attribute.  A separate program, unpic is used to convert the
  85.         screen dump to a normal file that may be printed or displayed.
  86.  
  87.  
  88.         18.1  Special Keys during Protocol Transfers
  89.  
  90.         Certain keys perform special functions when keyboarded during protocol
  91.         file transfers (XMODEM, Kermit, etc.).
  92.  
  93.         F1  Keyboarding F1 causes a protocol timeout and forces a retry.
  94.  
  95.         ALT-A Displays Kermit file transfer status.
  96.  
  97.         ALT-B Cancels the current Kermit or ZMODEM batch transfer.
  98.  
  99.  
  100.  
  101.  
  102.         __________
  103.  
  104.          1. Not necessarily the calling function or script
  105.  
  106.          2. In the term function, Ctrl-Break sends a break to the remote
  107.             unless it has been redefined with a set command.
  108.  
  109.          3. Use of this term, popularized in the J.F.K. administration, does
  110.             not imply endorsement of preemptive nuclear attacks on innocent
  111.             populations.
  112.  
  113.          4. When in host operation waiting for a call, NUKE drops DTR.
  114.  
  115.  
  116.  
  117.         (C) 1990 Omen Tech Inc                         Chapter 18 Special Keys
  118.  
  119.  
  120.         Version 17.78 TurboDial 2.35            Universal Line Printer Edition
  121.         ZCOMM User Manual                                                   93
  122.  
  123.         ALT-C Cancels the ZMODEM or Kermit session.
  124.  
  125.         ALT-F Skips the current ZMODEM or Kermit file transfer.
  126.  
  127.         ALT-Q Keyboarding Alt-Q during a protocol file transfer toggles a flag
  128.             that causes ZCOMM to disconnect when the transfer is completed.
  129.             This is most useful when downloading a long file.  As soon as the
  130.             file is transferred, ZCOMM will execute the string parameter
  131.             quitcmd (if set) and then disconnect the modem.  If keyboarded
  132.             during a Host Operation file transfer, ZCOMM will exit Host
  133.             Operation at the conclusion of the transfer.  The state of the
  134.             quit flag is displayed each time ALT-Q is keyboarded.
  135.  
  136.         ALT-S Keyboarding Alt-S displays status information on the console
  137.             screen only (even if in Host Operation).  The pattern number of
  138.             the last successful search (-1 if no match), the active search
  139.             patterns (if any), and the line numbers of the active scripts (if
  140.             any) are displayed to aid script debugging.
  141.  
  142.         ALT-V Keyboarding ALT-V will toggle the view option affecting the rb,
  143.             rc, rz, sb, sc, sx, and sz commands, and data transfers using the
  144.             Compuserve B protocol.
  145.  
  146.         ASCII Keyboarding a normal ASCII character (in the range of 00 to 7F)
  147.             will send that character to the modem.  This may be used for
  148.             protocol testing, or to terminate a modem's autodial handshake
  149.             without terminating ZCOMM's call retry count.
  150.  
  151.         Ctrl-X All ZMODEM and many YMODEM and XMODEM protocol programs
  152.             recognize a dozen successive Ctrl-X characters as a session abort
  153.             command.  If the remote computer appears to be "stuck" in a YMODEM
  154.             or ZMODEM transfer, keyboard ten Ctrl-X characters to abort the
  155.             protocol transfer.
  156.  
  157.         During a protocol transfer, normal keys are sent to the modem when
  158.         Zcomm is waiting for or receiving a packet.  This may be used to
  159.         reissue a file transfer command to the other computer if it becomes
  160.         apparent the original command was not accepted.
  161.  
  162.         Other uses for this pass thru capability include protocol testing.
  163.  
  164.         18.2  Local Editing Keys
  165.  
  166.         Emacs style character editing reduces the number of keystrokes needed
  167.         to enter and edit commands and strings.  Normally the cursor is at the
  168.         end of the line of text being keyboarded.  Printing characters insert
  169.         themselves at the cursor location.  The <ENTER> key enters/transmits
  170.         the entire line of text.
  171.  
  172.  
  173.  
  174.  
  175.  
  176.         (C) 1990 Omen Tech Inc                   Chapter 18 Local Editing Keys
  177.  
  178.  
  179.         Version 17.78 TurboDial 2.35            Universal Line Printer Edition
  180.         ZCOMM User Manual                                                   94
  181.  
  182.         Left, Ctrl-B moves the cursor to the left
  183.  
  184.         Right, Ctrl-F moves the cursor to the right
  185.  
  186.         Ctrl-Left cursor WORD left
  187.  
  188.         Ctrl-Right cursor WORD right
  189.  
  190.         Ctrl-A cursor to beginning of line
  191.  
  192.         Ctrl-E cursor to end of line
  193.  
  194.         Del, Ctrl-D delete character at cursor
  195.  
  196.         Backspace delete character to left of cursor
  197.  
  198.         Ctrl-W delete word to left of cursor
  199.  
  200.         Ctrl-End, Ctrl-K delete to end of line
  201.  
  202.         Ctrl-R refresh (redisplay) the line
  203.  
  204.         Ctrl-X delete entire line
  205.  
  206.         Down, Ctrl-N next history line
  207.  
  208.         Up, Ctrl-P previous history line
  209.  
  210.         Ctrl-U Argument Count (not available in term function)
  211.  
  212.         An initial Ctrl-U sets an argument count of 4.  Successive Ctrl-U
  213.         characters multiply the argument count by 4.  A decimal number may be
  214.         entered after Ctrl-U, and this number becomes the argument count.
  215.  
  216.         EXAMPLE: ^U^U Left moves the cursor 16 left
  217.  
  218.  
  219.         EXAMPLE: ^U5X inserts 5 "X" characters
  220.  
  221.  
  222.         EXAMPLE: ^U5^U?  inserts 20 "?" characters.
  223.  
  224.         Unix/Xenix flavors do not support Emacs style editing in the term
  225.         function.
  226.  
  227.  
  228.  
  229.  
  230.  
  231.  
  232.  
  233.  
  234.  
  235.         (C) 1990 Omen Tech Inc                        Chapter 18 Main Commands
  236.  
  237.  
  238.         Version 17.78 TurboDial 2.35            Universal Line Printer Edition
  239.         ZCOMM User Manual                                                   95
  240.  
  241.         19.  MAIN COMMANDS
  242.  
  243.         All commands and arguments must be entered in lower case except where
  244.         stated.
  245.  
  246.         You may shorten some commands by typing just the first portion that is
  247.         shown in caps.  For example, the "break" command may be entered as
  248.         "br".  Whether or not you abbreviate the command, it must be entered
  249.         in lower case.
  250.  
  251.         User defined Soft Keys are executed from the command prompt iff they
  252.         do not conflict with the permanent definitions described below.
  253.  
  254.         Except where stated, multiple commands can be written on one line
  255.         separated by ; (semicolon).  Commands that take a constant number of
  256.         arguments do not need a semicolon to delimit the end of the command.
  257.         If in doubt, use a semicolon to separate multiple commands.[1]
  258.  
  259.         @ The at sign may be used to indicate a telephone number starting with
  260.           the Touch-Tone(TM) A B C D * or # codes or a character escape.  If
  261.           the phone number contains spaces, it must be enclosed in double
  262.           quotes.  The leading @ is not sent to the modem.
  263.  
  264.           EXAMPLE: @#*-123-4567 Dials #*-123-4567.
  265.  
  266.  
  267.         %l-234-567-8901 (%l:letter l) For normal long distance dialing, the
  268.           string parameter l (letter l) defaults to "1" (digit 1).  To use an
  269.           alternative long distance service, set the l string parameter with a
  270.           modem command to dial the local access number, wait for the second
  271.           dial tone, and transmit the account number.
  272.  
  273.           SEE ALSO: "setsavenet" telephone directory entry
  274.  
  275.           A string of alternate phone numbers may be specified with the "+"
  276.           construction shown below.
  277.  
  278.         234-5678 A number given as a command invokes the dial script to
  279.           attempt a connection with the specified number.  Iff the modem is
  280.           currently connected to a remote modem, and the B numeric parameter
  281.           is non zero, ZCOMM pulses Data Terminal Ready, terminating the
  282.           connection.  ZCOMM character escapes may be used within the number
  283.           string to represent special characters.
  284.  
  285.  
  286.  
  287.         __________
  288.  
  289.          1. A space or two after each semicolon makes scripts easier for
  290.             humans to read.
  291.  
  292.  
  293.  
  294.         (C) 1990 Omen Tech Inc                        Chapter 19 Main Commands
  295.  
  296.  
  297.         Version 17.78 TurboDial 2.35            Universal Line Printer Edition
  298.         ZCOMM User Manual                                                   96
  299.  
  300.           EXAMPLE: 234-5678
  301.  
  302.  
  303.           When carrier is detected, ZCOMM executes the mconnect string (if
  304.           set) and proceeds to the next command
  305.  
  306.           One or several alternate phone numbers may be specified by appending
  307.           the previous number with +234-5678 for as many alternate numbers as
  308.           are desired.[2] When a connection is made, undialed alternates are
  309.           forgotten.  Alternate phone numbers need not support the same
  310.           speeds.  A redial count given to the call command repeats the
  311.           sequence of alternate numbers.
  312.  
  313.           EXAMPLE: cis  speed 2400 239-6124/mnp_s+239-6126/mnp_s+232-1032/300
  314.           This script line attempts a MNP (with software slow control) call to
  315.           the first two numbers, then a 300 bps call to the third number if
  316.           neither of the first two connected.
  317.  
  318.  
  319.           Iff no connection is made, script processing at the current level is
  320.           terminated.
  321.  
  322.           A number of modifiers are available depending on the type of modem
  323.           and the choice of dialing script used.  These are described in
  324.           Chapter 9.
  325.  
  326.  
  327.           SEE ALSO: nolog command, calllog string parameter, mcommand string
  328.           parameter
  329.  
  330.         a: Change the default disk to a:.  ZCOMM then prints the free storage
  331.           remaining on the selected disk.  The specified disk must be included
  332.           in the string parameter disks.
  333.  
  334.         abort Aborts any command or script in progress.  Closes all script
  335.           files that may be open.  Abort returns to the command prompt.
  336.  
  337.           SEE ALSO: quit command
  338.  
  339.         accept[[l]1] stringvar prompt (letter l, digit 1) Scripts often need
  340.           to prompt the user for file names and menu choices.
  341.  
  342.           Accept displays Prompt[3] to the user.  ZCOMM then reads keyboard
  343.  
  344.  
  345.         __________
  346.  
  347.          2. When using the mm224 dialing script.
  348.  
  349.          3. Prompt must be enclosed in quotes if it contains spaces.
  350.  
  351.  
  352.  
  353.         (C) 1990 Omen Tech Inc                        Chapter 19 Main Commands
  354.  
  355.  
  356.         Version 17.78 TurboDial 2.35            Universal Line Printer Edition
  357.         ZCOMM User Manual                                                   97
  358.  
  359.           input into the specified string variable.  Backspace and Ctrl-U
  360.           perform editing functions.  Characters are accepted from the user
  361.           until <ENTER> is typed.  If the H numeric parameter is non zero, an
  362.           empty string is returned if <ENTER> is not typed within the time
  363.           limit set by that parameter.  Acceptl translates the user's response
  364.           to lower case.  Acceptl1 returns a 1 character string in lower case
  365.           after the single character is keyboarded.
  366.  
  367.           Prompt is processed for string substitution and character escapes.
  368.           If the result begins with an ESC character, ZCOMM does not
  369.           reposition the cursor before accepting the string.  In writing
  370.           scripts, it may be useful to save the current screen location with
  371.           an escape sequence, then restore it with an escape sequence encoded
  372.           in the prompt string.
  373.  
  374.           EXAMPLE: accept s1 File: Displays the prompt File: and reads the
  375.           keyboarded response to string parameter s1.
  376.  
  377.  
  378.           EXAMPLE: acceptl1 s0 "Enter Menu Choice" Reads a single character
  379.           from the user, translates it to lower case, and assigns it to s0.
  380.  
  381.  
  382.           EXAMPLE: accept s0 "\E[20;60H\E[KFile Name: " Places the cursor at
  383.           line 20 column 60, clears the rest of the CRT line, displays the
  384.           prompt, and accepts input.
  385.  
  386.  
  387.           EXAMPLE: accept s6 " Your \E[1mFirst\E[0m name please " Uses
  388.           boldface video to highlight First as it appears in the prompt.
  389.  
  390.  
  391.           EXAMPLE: accept s2 "File "; rc %s2 Prompts the user for a file name,
  392.           then receives that file with XMODEM/CRC protocol.
  393.  
  394.  
  395.           EXAMPLE: accept xpassword "\E[mMaster Password: \E[8m"; lput "\E[m"
  396.           Uses invisible video (ESC [ 8 m) to allow a password to be entered
  397.           without visible echo.  The ESC [ m sequences reset the display to
  398.           normal (visible).
  399.  
  400.  
  401.           SEE ALSO: obey command, scripts
  402.  
  403.         ap file1 file2* (Append) Appends the contents of file1 to file2.  If
  404.           file2 does not exist, it is created.  Wildcards are not allowed.
  405.           The ap command closes any files that have been opened by the create,
  406.           f, open, t or > commands.  File1 and file2 are processed for string
  407.           parameter substitution.
  408.  
  409.  
  410.  
  411.  
  412.         (C) 1990 Omen Tech Inc                        Chapter 19 Main Commands
  413.  
  414.  
  415.         Version 17.78 TurboDial 2.35            Universal Line Printer Edition
  416.         ZCOMM User Manual                                                   98
  417.  
  418.         apd file1 file2* (Append-Delete) Appends the contents of file1 to
  419.           file2, then deletes file1.  If file2 does not exist, it is created.
  420.           If an error is detected writing file2, file1 is not deleted.
  421.           Wildcards are not allowed.  The apd command closes any files that
  422.           have been opened by the create, f, open, t or > commands.  File1 and
  423.           file2 are processed for string parameter substitution.
  424.  
  425.           EXAMPLE: apd %item Z%item.tmp
  426.  
  427.  
  428.         bdump outfile Dumps the contents of the modem interrupt input buffer
  429.           to outfile.  This command is useful for debugging as outfile will
  430.           contain the last characters received from the remote regardless of
  431.           what ZCOMM commands have been executed.  The most recently received
  432.           data appears at the end of outfile.  This command "tells it as it
  433.           is", writing all 8 bits of each character to outfile.  If few
  434.           characters have been received from the remote, some of outfile will
  435.           consist of nulls or garbage.  The bdump command is often used as a
  436.           post mortem diagnostic dump after a failed script or file transfer.
  437.           This command is not available on OS/2, and X.PC flavors of ZCOMM.
  438.  
  439.         bg Indicates ZCOMM is running in the background with no user at the
  440.           keyboard.
  441.  
  442.           SEE ALSO: fg command, df test condition
  443.  
  444.         BReak Sends a 200 millisecond break signal.
  445.           N.B.: Some modems do not correctly pass the break signal to the
  446.           remote.
  447.  
  448.           SEE ALSO: Ctrl-Break key, break string parameter, zmodem B numeric
  449.           parameter
  450.  
  451.         BROwse pathspec Browse through the files specified in pathspec.  If
  452.           pathspec is empty, all files are presented.  For each matched
  453.           pathname, the filename, date, and length of the file are displayed.
  454.           The status line displays some of the commands which may be applied
  455.           to each file.  Chapter 19.4 describes the browse subcommands, which
  456.           provide extensive capabilities for individually selected files.
  457.  
  458.         bye Terminate the connection in progress by sending a long space and
  459.           then dropping DTR (Data Terminal Ready).[4] After a pause, DTR is
  460.           reasserted to allow the modem to originate or answer another
  461.           call.[5]
  462.  
  463.  
  464.         __________
  465.  
  466.          4. The modem must be configured to use Data Terminal Ready (DTR).
  467.  
  468.          5. Most dialing scripts include an initial bye command to make sure
  469.  
  470.  
  471.         (C) 1990 Omen Tech Inc                        Chapter 19 Main Commands
  472.  
  473.  
  474.         Version 17.78 TurboDial 2.35            Universal Line Printer Edition
  475.         ZCOMM User Manual                                                   99
  476.  
  477.           SEE ALSO: o, off commands
  478.  
  479.         call [-N] [name][.path][,modifier] Prepare ZCOMM for a new task and
  480.           invoke an entry in the Phone Directory.
  481.  
  482.           The 7, A, a, b, C, c, E, e, g, H, h, i, j, n, o, P, p, q, r, S, s,
  483.           t, u, v, w, X, x, Z, and z modes are reset.  The d mode is set.  The
  484.           e, f, g, k, m, p, q, t, w, Kermit 8, zmodem C, e, l, L, p, t, T, w,
  485.           and W parameters are reset to their default values.  The search
  486.           patterns are erased.  Permanent string parameters set with the set
  487.           _svar command are set to empty.
  488.  
  489.           If path has been specified, it is searched for a line beginning with
  490.           name.  Otherwise, ZCOMM searches the telephone directory.  An
  491.           optional modifier (string with a leading comma), if specified, is
  492.           not used in the directory search.
  493.  
  494.           If the search is successful, the entire directory entry name is
  495.           copied to the remote string parameter.  The complete argument
  496.           entered on the command line is stored in the args string parameter
  497.           visible to the called script.  If the script has a READ ONLY
  498.           attribute, ZCOMM is unrestricted during execution of the script.
  499.           ZCOMM then executes the commands on the rest of the line (if any),
  500.           and on succeeding lines beginning with a space or tab.  If the v
  501.           numeric parameter is greater than zero, each command from the file
  502.           is displayed on the screen before it is executed.
  503.  
  504.           It is not necessary to type the entire name as it appears in the
  505.           telephone directory, as ZCOMM will find the first entry that name is
  506.           a prefix of.  Iff name is empty, execution begins with the first
  507.           line of path.
  508.  
  509.           EXAMPLE: call cis1200
  510.                call cis1
  511.                call cis.C:/newscript
  512.  
  513.  
  514.           EXAMPLE: call genie,upl Invokes the genie telephone directory entry
  515.           with the modifier ,upl available to the called script.
  516.  
  517.           The call command is not limited to making connections.  For example,
  518.           "call host" in the distribution PHODIR.t file conditions a Hayes
  519.           compatible modem to answer incoming calls silently, set parameters,
  520.           and activates ZCOMM's host operation.
  521.  
  522.  
  523.  
  524.         ______________________________________________________________________
  525.  
  526.             any previous call is disconnected.
  527.  
  528.  
  529.  
  530.         (C) 1990 Omen Tech Inc                        Chapter 19 Main Commands
  531.  
  532.  
  533.         Version 17.78 TurboDial 2.35            Universal Line Printer Edition
  534.         ZCOMM User Manual                                                  100
  535.  
  536.           Most directory entries include a telephone number to dial.  If ZCOMM
  537.           is used with an autodial modem, the number of retries N (default
  538.           none) may be specified.
  539.  
  540.           EXAMPLE: call -40 cbbs-r Attempts 40 retries before giving up.
  541.  
  542.           The interval between retries is set by the i numeric parameter.
  543.  
  544.           EXAMPLE: pi4 Sets the interval between retries to 4 seconds.
  545.  
  546.           Words To the Wise: Abuse of the retry feature by continually calling
  547.           busy numbers may incur the wrath of the Telephone Company.
  548.           Especially with Message Unit Accounting, Big Brother may be watching
  549.           your telecommunications habits.  Some long distance services (MCI,
  550.           Sprint, AT&T, etc.) charge for unsuccessful calls, especially if the
  551.           phone is allowed to ring (or ring busy) for more than a few seconds.
  552.  
  553.           Consult your telephone company about legal limits to the number and
  554.           frequency of retries.
  555.  
  556.           Since some computer services will disconnect within a short time if
  557.           no login is attempted, you should start communicating as soon as the
  558.           modems are connected.  ZCOMM sounds the bell after making the
  559.           connection if retries have been specified.
  560.  
  561.           The source, gosub and call commands may be nested with up to six
  562.           command/phones file descriptors open at once.[6] A label may be the
  563.           target of a call command provided the trailing colon is included in
  564.           name.
  565.  
  566.         cat pathspec For Unix users, a synonym to the type command (q.v.).
  567.  
  568.         cd [dir] Change to directory dir.  If Restricted, dir is checked for a
  569.           parent directory ("cd  .."), and absolute paths ("cd  /src") not
  570.           prefixed by the home string parameter.  Giving cd without an
  571.           argument changes to the directory stored in the home string
  572.           parameter.[7] ZCOMM then stores the current directory in the pwd
  573.           string parameter and displays it unless the v numeric parameter is
  574.           less than 0.
  575.  
  576.           EXAMPLE: cd  /tmp
  577.  
  578.  
  579.         __________
  580.  
  581.          6. Deep nesting may require a decrease in the circular buffer memory
  582.             allocation, see Chapter 16.
  583.  
  584.          7. The home parameter is set to the current directory when ZCOMM is
  585.             invoked, but may be changed with the set command.
  586.  
  587.  
  588.  
  589.         (C) 1990 Omen Tech Inc                        Chapter 19 Main Commands
  590.  
  591.  
  592.         Version 17.78 TurboDial 2.35            Universal Line Printer Edition
  593.         ZCOMM User Manual                                                  101
  594.  
  595.           N.B.: When operating restricted, the home string parameter must
  596.           point to a valid directory in order to enforce the intended
  597.           directory path restriction.
  598.  
  599.           SEE ALSO: cdd and pwd commands, home and pwd string parameters
  600.  
  601.         cd  D:dir When a disk drive is specified with the cd command, the
  602.           current directory on that drive is changed but ZCOMM remains logged
  603.           in on the current drive and directory.  If Restricted, dir is
  604.           checked for a disk drive ("cd  b:/foo") not contained in the disks
  605.           string parameter.
  606.  
  607.           EXAMPLE: cd D:/tmp
  608.  
  609.  
  610.         cdd D:dir Change to (log in to) disk D and then to directory dir on
  611.           the specified disk.  If dir is not specified, the root directory is
  612.           assumed.  ** This is a shorthand equivalent to a D: command followed
  613.           by a chdir dir command.
  614.  
  615.           SEE ALSO: cd command
  616.  
  617.         chat Enter the term function to chat keyboard to keyboard.  Characters
  618.           typed by either keyboard are echoed to both ends, and RETURNS echo
  619.           as RETURN/LINEFEED.  In Host Operation, chat exits if the caller
  620.           types Ctrl-Z.
  621.  
  622.           Chat will become hostile if the other end also echoes characters.
  623.           (Try it sometime on a timesharing system; it's fun.)
  624.  
  625.         close Writes the contents of the circular buffer iff a receive file is
  626.           open, then closes the receive and transmit files.  ZCOMM complains
  627.           if no files were open.
  628.  
  629.           SEE ALSO: nolog command
  630.  
  631.         closerx Iff a receive file is open, writes the circular buffer then
  632.           closes the receive file.
  633.  
  634.           SEE ALSO: nolog command
  635.  
  636.         closetx Closes the transmit file, if it is open.
  637.  
  638.           SEE ALSO: nolog command
  639.  
  640.         cl Clears the screen.
  641.  
  642.         cls Resets display modes and clears the screen.
  643.  
  644.         CONFerence Enters the term function with a 1 line window for composing
  645.           commands and text.  Chapter 22.5 gives details.
  646.  
  647.  
  648.         (C) 1990 Omen Tech Inc                        Chapter 19 Main Commands
  649.  
  650.  
  651.         Version 17.78 TurboDial 2.35            Universal Line Printer Edition
  652.         ZCOMM User Manual                                                  102
  653.  
  654.         crc pathspec Print the CRC-32 and character count for the specified
  655.           files.  The crc command verifies the identity of two (or more)
  656.           copies of a file.  Iff the lengths and CRC-32's of two files are the
  657.           same, the files are almost certainly identical.  Comparing files
  658.           with the crc command is faster than transmitting a second copy for
  659.           character by character comparisons.
  660.  
  661.           EXAMPLE: "crc", "crc *.c"
  662.  
  663.           HINT: To generate a file containing the CRC's of the files in the
  664.           current directory:
  665.  
  666.                >crc.lst
  667.                crc *.*
  668.                close
  669.  
  670.           After the files are copied, run the commands above (with a different
  671.           file name), then compare the two files with DIF.EXE to detect any
  672.           that have changed.
  673.  
  674.           SEE ALSO: sum, wc commands
  675.           Source for a public domain Unix/DOS version of CRC is available.
  676.  
  677.         create [-modes] outfile If a receive capture file is open as the
  678.           result of a create or t filename command, write the circular buffer
  679.           and close it.  Then create outfile for use with the term function
  680.           with modes.  The create command is especially useful when you don't
  681.           want to enter the term function immediately.
  682.  
  683.           EXAMPLE: create -ys /tmp/cbbs.tmp[8]
  684.  
  685.  
  686.           SEE ALSO: > command
  687.  
  688.         createx outfile Similar to the create command, but does not open
  689.           outfile if a file with the same pathname already exists.  The
  690.           resulting error message may be suppressed by setting the v numeric
  691.           parameter negative.  Scripts may test for success with the r test
  692.           condition.  The createx command may be used to manage semaphores to
  693.           lock resources or work entries used by multiple instances of a
  694.           program.  The createx command is available on Unix and OS/2 flavors.
  695.  
  696.           SEE ALSO: kill command
  697.  
  698.  
  699.  
  700.         __________
  701.  
  702.          8. The y mode overwrites any existing file with the same name.  The s
  703.             mode strips most control characters from the resulting disk file.
  704.  
  705.  
  706.  
  707.         (C) 1990 Omen Tech Inc                        Chapter 19 Main Commands
  708.  
  709.  
  710.         Version 17.78 TurboDial 2.35            Universal Line Printer Edition
  711.         ZCOMM User Manual                                                  103
  712.  
  713.         del pathspec Delete the specified files.  No message is printed if one
  714.           or more of the specified files could not be deleted.  No
  715.           confirmation is requested for mass deletes.
  716.  
  717.           WARNING: As with all ZCOMM pathspec specifications, a directory name
  718.           expands to all files in that directory.
  719.           N.B.: Do not attempt to delete an open file on DOS, especially the
  720.           history file.
  721.  
  722.           SEE ALSO: browse command
  723.  
  724.         demand password Scripts must often verify a caller's identity by
  725.           asking for a password.  The ZCOMM password command allows a caller
  726.           three chances to enter a given password.  Failure results in
  727.           disconnection.
  728.  
  729.           Password is processed for character escapes and string
  730.           substitutions.  All security restrictions on string parameters are
  731.           enforced.
  732.  
  733.           If the result is empty, no password is demanded.  Otherwise the user
  734.           is prompted to enter a string matching password in the correct case.
  735.           Keyboard input is not echoed.
  736.  
  737.           Three attempts to enter password are allowed.  If the password is
  738.           not correctly entered, DTR is pulsed to force the modem to
  739.           disconnect the caller, and the ?  numeric parameter is set negative.
  740.  
  741.           EXAMPLE: demand %password Requires the caller to enter a string
  742.           matching the contents of the password string parameter.
  743.  
  744.  
  745.         dir pathspec Display pathnames matching pathspec alphabetized across
  746.           the page.  Wildcard filename expansions are alphabetical.
  747.  
  748.           EXAMPLE: dir
  749.  
  750.  
  751.           EXAMPLE: dir y*.c *.h
  752.  
  753.  
  754.         dirr pathspec Displays the directory with length and creation date of
  755.           each file.  dirr displays the number of files matched, number of
  756.           blocks, number of kb in those files, and estimated transmission time
  757.           at the current transmission speed assuming the fastest protocol
  758.           available (ZMODEM or YMODEM-g).  XMODEM and Kermit transfers take
  759.           longer than the displayed estimates.  Wildcard filename expansions
  760.           are alphabetical.
  761.  
  762.         dird pathspec Long Form directory, sorted by date.
  763.  
  764.  
  765.  
  766.         (C) 1990 Omen Tech Inc                        Chapter 19 Main Commands
  767.  
  768.  
  769.         Version 17.78 TurboDial 2.35            Universal Line Printer Edition
  770.         ZCOMM User Manual                                                  104
  771.  
  772.         dirt pathspec Long Form directory, reverse sorted by date.
  773.  
  774.         dirl pathspec Long Form directory, sorted by file length.
  775.  
  776.         dirs pathspec Long Form directory, reverse sorted by file length.
  777.  
  778.         dirx pathspec Long Form directory, sorted by file extension.
  779.  
  780.         DISable{-modes} Disable mode(s) affecting the term function.  Chapter
  781.           21 describes modes affecting the term function.
  782.  
  783.           EXAMPLE: dis -t Disables throttle (t mode).
  784.  
  785.  
  786.         display [[no]dismode] ... Without an argument, prints the display
  787.           modes.  Display modes preceded by NO are turned off.  With one or
  788.           more arguments, turn on the specified display mode(s).  If an
  789.           argument is preceded by no, the specified display mode is turned
  790.           off.
  791.  
  792.           If an emulation is specified, it must be the first argument.
  793.           display command argument changing the terminal emulation (vt100,
  794.           lsi-adm3a, 3101, dumb) disables nlmode and overstrike.
  795.  
  796.           The display modes are:
  797.  
  798.           vt100 Emulate DEC VT-100 and VT-102 display codes and most Teletype
  799.                 5425 codes.  VT-52 and Zenith H-19 codes are the default.
  800.  
  801.                 SEE ALSO: 101.MK,STD.MK, script files
  802.  
  803.           lsi-adm3a Emulate Lear Siegler ADM3a and Televideo 9xx control
  804.                 codes.
  805.  
  806.           dasher Emulate Data General Dasher terminals.
  807.  
  808.           3101  Executes IBM 3101 and TI 940 escape codes.
  809.  
  810.           wyse  Emulate Wyse terminals in native mode, allow switching the
  811.                 keyboard to keyscan mode.
  812.  
  813.                 SEE ALSO: WYS.MK script file
  814.  
  815.           dumb  Only null, bs, tab, cr and lf are executed, all others
  816.                 display.  As in real life, dumb takes precedence over vt100,
  817.                 vt52, and lsi-adm3a emulation.
  818.  
  819.           inhibit Inhibits the display (nothing prints).
  820.  
  821.                 SEE ALSO: Q mode
  822.  
  823.  
  824.  
  825.         (C) 1990 Omen Tech Inc                        Chapter 19 Main Commands
  826.  
  827.  
  828.         Version 17.78 TurboDial 2.35            Universal Line Printer Edition
  829.         ZCOMM User Manual                                                  105
  830.  
  831.           nlmode Received newlines (linefeed) display as return/linefeed.  The
  832.                 Enter key is sent as CR/LF.
  833.  
  834.           bell=visual Instead of sounding on the speaker, bell characters
  835.                 cause flashing notes to appear on the screen.
  836.  
  837.           overstrike Overstruck characters are displayed in bold face or
  838.                 underline (reverse video on CGA) as appropriate.
  839.  
  840.           autowrap The 81st character prints on a new line with possible
  841.                 scrollup.
  842.  
  843.           rautowrap Allow a backspace from the lest margin to reverse wrap to
  844.                 the last character position on the previous line.
  845.  
  846.           8bit  Decode 8bit control characters and G1 character set.
  847.  
  848.           stat=off Disables ZCOMM's status line.
  849.  
  850.           warpdrive Provides higher display speed without scrolling flicker,
  851.                 but causes noise (snow/chromablizzard) with CGA display
  852.                 adapters.
  853.  
  854.           mapkb Allow escape codes from the remote or a file to active
  855.                 alternate keyboard mapping.  The keyboard mapping is defined
  856.                 with a series of mk commands, such as those contained in the
  857.                 std.mk (standard keyboard) or 101.mk (101 key extended
  858.                 keyboard) files.  Other XXX.mk files may be provided; the
  859.                 first few lines of these files indicate the keyboard
  860.                 configuration they set up.  ZCOMM comes initialized with the
  861.                 std.mk mapping, which requires NumLock to be on.
  862.  
  863.                 EXAMPLE: source std.mk Defines a VT100 keyboard mapping for
  864.                 standard PC and PC-AT keyboards.
  865.  
  866.                 The term function keyboard mapping enabled by the mapkb
  867.                 command may override some ZCOMM functions.
  868.           A display nlmode nobell=visual Turns on nlmode display mode and
  869.           turns off the visual bell.
  870.  
  871.  
  872.           EXAMPLE: display vt100 Enables VT100/VT102 emulation used by many
  873.           computer systems.
  874.  
  875.  
  876.           SEE ALSO: tcs command
  877.  
  878.         dump pathspec Dump the named files in a side by side hex/ASCII format,
  879.           similar to the CP/M users' group DUMP program.  The ending character
  880.           number is also displayed.  Zero length files are not displayed.
  881.  
  882.  
  883.  
  884.         (C) 1990 Omen Tech Inc                        Chapter 19 Main Commands
  885.  
  886.  
  887.         Version 17.78 TurboDial 2.35            Universal Line Printer Edition
  888.         ZCOMM User Manual                                                  106
  889.  
  890.         echo[c|f] [-n] string Echo a line containing a single argument string
  891.           in reverse video.  The optional -n suppresses reverse video and
  892.           linefeeds.  Tabs should not be used with the echo command.  The
  893.           echoc command also echoes its argument to the capture file (if
  894.           open), without reverse video.  The echof command echoes its argument
  895.           to the capture file only.
  896.  
  897.           EXAMPLE: echoc "File not Accepted" Outputs a line to the screen and
  898.           to the capture file.
  899.  
  900.  
  901.           EXAMPLE: echo "Dave, This conversation can serve no further
  902.           purpose." Displays a line on the screen only.
  903.  
  904.  
  905.           SEE ALSO: lput command, r numeric parameter, character escapes
  906.  
  907.         egrep[m] regular-expression pathspec ** Display lines in the specified
  908.           files matching regular-expression.  Regular Expressions are
  909.           discussed in Chapter 26.
  910.  
  911.           The egrepm command finds a line matching regular-expression in each
  912.           of the specified files, and then pages through the file beginning
  913.           with the matched line.  At the end of each screen, ZCOMM accepts the
  914.           same subcommands used with the findm command.
  915.  
  916.           EXAMPLE: egrep "^Subject:" *.* Displays all lines that begin with
  917.           "Subject:".
  918.  
  919.  
  920.           SEE ALSO: findmore command
  921.  
  922.           The egrep implementation does not strip the trailing CR/LF from
  923.           lines read from the disk.  This affects use of the $ regular
  924.           expression magic character.  When using the $ magic character, the
  925.           CR/LF at the end of normal lines must be represented as "..$".
  926.  
  927.         egrepq regular-expression pathspec ** Silently searches the specified
  928.           files for the first line matching regular-expression.  Upon a
  929.           successful search, the contents of this line are stored in the z0
  930.           string variable and the ?  numeric parameter is incremented.  The
  931.           egrepq command is useful for fetching password information from a
  932.           disk file.
  933.  
  934.           SEE ALSO: obey command, findq command
  935.  
  936.         else Execute the command(s) on the rest of the line if the last if
  937.           test performed on the current script level was false.
  938.           N.B.: While else statements in programming languages are connected
  939.           to a particular if statement according to syntax, the connection in
  940.           ZCOMM is to the last if statement executed on the level, regardless
  941.  
  942.  
  943.         (C) 1990 Omen Tech Inc                        Chapter 19 Main Commands
  944.  
  945.  
  946.         Version 17.78 TurboDial 2.35            Universal Line Printer Edition
  947.         ZCOMM User Manual                                                  107
  948.  
  949.           of goto's.
  950.  
  951.         ENAble {-modes} Enable mode(s) affecting the term function.  Chapter
  952.           21 describes modes affecting the term function.
  953.  
  954.           EXAMPLE: ena -h Enables half-duplex (local echo) Half-duplex mode
  955.           causes the term function to display keyboarded characters.
  956.  
  957.  
  958.         estimate length [speed] Use the specified length and optional
  959.           specified effective speed when displaying information for the next
  960.           receive file.  A length of 0 bypasses the length substitution.  Once
  961.           a speed (in effective bits per second) is given, it is used for all
  962.           locally displayed transmission time calculations until the next
  963.           speed or port command.
  964.  
  965.           EXAMPLE: estimate z2 Uses the file length stored in string variable
  966.           z2 in calculating the transmission time estimate for the next
  967.           received file.
  968.  
  969.  
  970.           EXAMPLE: speed 19200; estimate 0 2400 Use an effective transmission
  971.           speed of 2400 for transmission time estimates instead of the 19200
  972.           bps interface speed.
  973.  
  974.  
  975.         exit [code] Exit to the operating system with optional code.
  976.  
  977.           SEE ALSO: x, o, off commands
  978.  
  979.         EXPand sourcefile pathspec ** For each pathname in pathspec, execute
  980.           the commands in sourcefile with the string parameter item set to the
  981.           current pathname.  The commands in sourcefile must not themselves
  982.           contain wildcards (* or ?) or directory pathnames.  If no files
  983.           match pathspec, sourcefile is not executed.  If the script executed
  984.           has a READ ONLY attribute, ZCOMM is unrestricted during execution of
  985.           the script.
  986.  
  987.           EXAMPLE: expand plxupl 001* Executes the script plxupl once for each
  988.           file matching the wild card specification 001*.
  989.  
  990.  
  991.           EXAMPLE: expand a *.arc where the file a contains:
  992.                obey "!pkxarc -v %item >> arclist"
  993.           lists the contents of all .arc files to arclist.
  994.  
  995.  
  996.           Chapter 99 explains the use of this command in more detail.
  997.  
  998.         f [-modes] file The f (think of "file") command initiates transmission
  999.           of file with the term function.  One or more term function modes
  1000.  
  1001.  
  1002.         (C) 1990 Omen Tech Inc                        Chapter 19 Main Commands
  1003.  
  1004.  
  1005.         Version 17.78 TurboDial 2.35            Universal Line Printer Edition
  1006.         ZCOMM User Manual                                                  108
  1007.  
  1008.           (described in Chapter 21) may be enabled with the optional modes
  1009.           flag.
  1010.  
  1011.           If q (TWX) mode is enabled, transmission pauses until the called
  1012.           system's answerback restarts it with an XON, or until g mode is set.
  1013.           Otherwise, any XOFF induced transmission pause is reset.
  1014.  
  1015.           Once the file has been opened with the f command, a pattern match or
  1016.           keyboarding F1 or ALT-X will exit the term function with file
  1017.           incompletely transmitted.  The rest of the file may be transmitted
  1018.           by the t, F2, or wait commands.
  1019.  
  1020.           EXAMPLE: f -px message Uploads message paced by the p mode, which
  1021.           sends a carriage return and pauses at the end of each transmitted
  1022.           line until the remote responds with the prompt character (default
  1023.           line feed).  The x mode makes the term function return to the script
  1024.           after the file has been transmitted.
  1025.  
  1026.  
  1027.           EXAMPLE: set eolstr "\r."; pp1000; pg58; f -p file Is useful for
  1028.           uploading a prepared message to a CompuServe bulletin boards using
  1029.           the "SIG" editor (not FILGE).  The eolstr setting sends a carriage
  1030.           return and period after each line to prevent the CompuServe software
  1031.           from reformatting the message.  Pp10000 Sets the pause timeout to a
  1032.           long time.  Pg58 Sets the prompt character to ":".  f -p file
  1033.           Transmits the file.
  1034.  
  1035.  
  1036.           SEE ALSO: b, g, p, r, n, t, w, x, X modes, eolstr string parameter,
  1037.           t and wait commands
  1038.  
  1039.         fail Terminate the current expand command, otherwise return from the
  1040.           current script level with failure status.
  1041.  
  1042.           If called directly by another level of script, that level is
  1043.           terminated.
  1044.  
  1045.           The fail command also causes the term function to exit, to allow a
  1046.           function key to be programmed with a macro that exits the term
  1047.           function.
  1048.  
  1049.           If called implicitly by a number presented for dialing, fail
  1050.           terminates the current dialing attempt.  If no retries are left, the
  1051.           call is abandoned.
  1052.  
  1053.         fg Indicates ZCOMM is running in the foreground with a user at the
  1054.           keyboard.
  1055.  
  1056.           SEE ALSO: bg command, df test condition
  1057.  
  1058.  
  1059.  
  1060.  
  1061.         (C) 1990 Omen Tech Inc                        Chapter 19 Main Commands
  1062.  
  1063.  
  1064.         Version 17.78 TurboDial 2.35            Universal Line Printer Edition
  1065.         ZCOMM User Manual                                                  109
  1066.  
  1067.         fget outfile * Gets 8 bit raw data from the modem to outfile without
  1068.           any protocol.  No data is displayed on the screen.  Keyboarding F1
  1069.           terminates recording; any other keyboarded character is sent to the
  1070.           remote.  Iff the g numeric parameter is set to to some value other
  1071.           than its default of 10 (line feed), the fget command terminates upon
  1072.           reading and storing a character matching the g numeric parameter.
  1073.           The fget command also terminates recording on loss of carrier detect
  1074.           signal.
  1075.  
  1076.           This command can be used when the flow of data from the remote
  1077.           cannot be regulated.  The maximum rate attainable without loss of
  1078.           data is limited by the maximum interrupt latency of the operating
  1079.           system and active device drivers.  The time required to write a 512
  1080.           character buffer to disk may also limit the maximum average data
  1081.           rate.  Each 512 character block must be written before the modem
  1082.           interrupt input buffer overflows with new data.  If the startup time
  1083.           for a floppy disk is excessive, better results will be obtained
  1084.           writing to a hard disk or ramdisk[9] if a suitable device is
  1085.           available.  Tests with an IBM Personal Computer, DOS 2.1, and a
  1086.           Maynard Electronics hard disk suggest that no characters are lost at
  1087.           9600 baud.  (Your results will vary depending on your configuration
  1088.           and programming habits.  California estimates lower.)
  1089.  
  1090.           EXAMPLE: fget rawdata
  1091.  
  1092.  
  1093.         find string pathspec Find and display lines containing matches to
  1094.           string in the specified files.  Lower case characters in string
  1095.           match either case; upper case characters in string match upper case
  1096.           characters only.  If string contains spaces, tabs, or semicolon, it
  1097.           must be enclosed by double quote characters.  ZCOMM C style escapes
  1098.           may be used to represent control characters and string parameters to
  1099.           be searched for.  Assuming normal DOS files (with CR/LF at the end
  1100.           of each line), a \n at the beginning of string forces a match to the
  1101.           beginning of a line.  A \r at the end of string (\n if the file(s)
  1102.           have no returns in them) forces a match at the end of the line.
  1103.  
  1104.           The file name being searched and its length are displayed in the
  1105.           status line.  For each line that contains a match to string, the
  1106.           file name (if more than one file), line number, and the text of the
  1107.           line are displayed.
  1108.  
  1109.           EXAMPLE: find count *.c Finds all occurrences of count or COUNT in
  1110.           the named files.
  1111.  
  1112.  
  1113.  
  1114.         __________
  1115.  
  1116.          9. See comments on Extended Memory ramdisks in Chapter 34.
  1117.  
  1118.  
  1119.  
  1120.         (C) 1990 Omen Tech Inc                        Chapter 19 Main Commands
  1121.  
  1122.  
  1123.         Version 17.78 TurboDial 2.35            Universal Line Printer Edition
  1124.         ZCOMM User Manual                                                  110
  1125.  
  1126.           SEE ALSO: egrep command
  1127.  
  1128.         FINDMore string pathspec Findmore finds a line matching string in each
  1129.           of the specified files, and then pages through the file beginning
  1130.           with the matched line.  Otherwise, it is similar to the find
  1131.           command.  When the screen is filled up, the prompt More?  appears.
  1132.           Typing space displays another screenfull.  Typing n skips to the
  1133.           next instance of string that has not yet been displayed.  Typing ^Q
  1134.           or ^S displays one more character from the file.  Typing ^X skips to
  1135.           the next file.
  1136.  
  1137.           SEE ALSO: egrepm, page commands
  1138.  
  1139.         findq string pathspec Silently searches the specified files for the
  1140.           first line matching string.  The processing of string is identical
  1141.           to the find command described above.  Upon a successful search, the
  1142.           contents of this line are stored in the z0 string variable and the ?
  1143.           numeric parameter is incremented.  The findq command is useful for
  1144.           fetching password information from a disk file.
  1145.  
  1146.           SEE ALSO: egrepq command
  1147.  
  1148.         finish Terminates Kermit server operation on the remote system.
  1149.  
  1150.         fput file * Puts data from file to the remote at maximum speed without
  1151.           any protocol.  After each 512 characters, the number of characters
  1152.           transmitted is displayed in the status line, and the keyboard is
  1153.           polled.  Any key will abort the transfer.  This is the fastest way
  1154.           ZCOMM can transmit characters to the modem, with possible peak
  1155.           speeds greater than 19kb.  This command is useful for testing RS232
  1156.           peripherals at high peak rates such as 56 kilobaud.
  1157.  
  1158.           EXAMPLE: fput datafile
  1159.  
  1160.  
  1161.         fpute file * Echoplex transmit a file to the remote, waiting for the
  1162.           correct echo to each character transmitted (for Throttle/10
  1163.           seconds).  The echoed character is sent to the CRT screen.  If fpute
  1164.           receives a space as an echo to a tab, fpute waits for the spaces to
  1165.           stop echoing for at least 100 milliseconds before resuming
  1166.           transmission.  Transfer speed thus suffers when tabs are present in
  1167.           the transmitted file unless the remote can be set to echo tabs as
  1168.           tab characters instead of expanding them to spaces.  Throughput is
  1169.           less than 1/3 of normal because of the echo delay.
  1170.  
  1171.           Fpute counts each time the correct character is not echoed as an
  1172.           error.
  1173.  
  1174.           With n mode, fpute transmits only a linefeed at the end of each
  1175.           line.  With r mode, fpute transmits only a carriage return at the
  1176.           end of each line.  Most applications would use one of these modes.
  1177.  
  1178.  
  1179.         (C) 1990 Omen Tech Inc                        Chapter 19 Main Commands
  1180.  
  1181.  
  1182.         Version 17.78 TurboDial 2.35            Universal Line Printer Edition
  1183.         ZCOMM User Manual                                                  111
  1184.  
  1185.           CPMEOF (Ctrl-Z) terminates the file transmission unless b mode is
  1186.           set.
  1187.  
  1188.           Because fpute waits for the correct echo to each character sent,
  1189.           fpute should be used for transmitting characters to programs that
  1190.           echo exactly.
  1191.  
  1192.           Often it is easy to write a simple receive routine to synchronize
  1193.           with the sender by echoing each character received.  On some
  1194.           microcomputer systems, the device "TTY:" does just that.  Fpute is
  1195.           especially useful for "spoon feeding" files to the serial inputs of
  1196.           microcomputers and minicomputers.
  1197.  
  1198.           SEE ALSO: f command
  1199.  
  1200.         get filespec Instructs a remote Kermit server to the transmit the
  1201.           specified file(s), then receives them.  The form of filespec varies
  1202.           with the remote system; it must be quoted if it contains any special
  1203.           characters or spaces.  The get command only operates with a Kermit
  1204.           server; use kermit rb to receive files from a regular Kermit
  1205.           program.
  1206.  
  1207.         goback label Search the current script file for label: and execute
  1208.           commands starting at that line.  The goback command begins the
  1209.           search at the beginning of the file.  It is faster than the goto
  1210.           command which begins the search at the current line.
  1211.  
  1212.           SEE ALSO: goto command
  1213.  
  1214.         gosub name[.scriptfile] Call a script as a subroutine.  The phone
  1215.           directory is searched for name unless another file is specified with
  1216.           .scriptfile.  Gosub has the same action as the call command (q.v.),
  1217.           but does not reset modes, disconnect the modem, or modify the remote
  1218.           parameter.
  1219.  
  1220.           EXAMPLE: gosub dosig Executes the dosig entry in the telephone
  1221.           directory.
  1222.  
  1223.  
  1224.           EXAMPLE: gosub .%lib/baud.t Executes the commands in c:/yam/baud.t
  1225.           assuming the lib string parameter contains c:/yam.
  1226.  
  1227.  
  1228.           SEE ALSO: call command
  1229.  
  1230.         goto label Search the current script file for label: and execute
  1231.           commands starting at that line.  A label begins at the first column
  1232.           and ends with a colon (:).  Iff label precedes the current script
  1233.           line, the goback command will locate the target label more quickly.
  1234.           The goto command is valid only within a script or telephone
  1235.           directory entry.  Please refer to Chapter 99 for examples using the
  1236.  
  1237.  
  1238.         (C) 1990 Omen Tech Inc                        Chapter 19 Main Commands
  1239.  
  1240.  
  1241.         Version 17.78 TurboDial 2.35            Universal Line Printer Edition
  1242.         ZCOMM User Manual                                                  112
  1243.  
  1244.           pattern, if, goto, and source commands.
  1245.  
  1246.         grab svar Grab reads a line from the currently open transmit file into
  1247.           the specified string parameter svar.  Unless b mode is on, all
  1248.           characters starting with the first CR and/or LF are discarded.  Grab
  1249.           inhibits transmission of the open file until g mode is explicitly
  1250.           set by a command.
  1251.  
  1252.           On end of file the transmit file is closed and the string parameter
  1253.           is set empty.  End of file can be tested with the t test condition.
  1254.  
  1255.           SEE ALSO: putv command
  1256.  
  1257.         HAndshake {off|sw|on|cts|dsr|dcd|both|slow} Some modems and printers
  1258.           cannot accept continuous full speed data.  These devices send
  1259.           control characters (XOFF and XON) for flow control, or generate a
  1260.           hardware flow control signal on the CTS, DSR, or DCD pin.  The
  1261.           Handshake command controls the modem port hardware handshake
  1262.           (default sw).[10]
  1263.  
  1264.           If hardware handshaking is selected, an ON to OFF transition on the
  1265.           specified line pauses transmission, and an XON character will not
  1266.           override the hardware restraint.
  1267.  
  1268.           After a timeout set by the S numeric parameter (default 60 seconds),
  1269.           or if characters are in the keyboard input buffer, a warning message
  1270.           is displayed, the restraint is released, and characters are sent.
  1271.  
  1272.           As a special case, handshake on obeys output flow control with the
  1273.           CTS input signal, asserts input flow control with the RTS output
  1274.           signal, and disables the transmission of XOFF characters when the
  1275.           modem input buffer becomes nearly full.
  1276.  
  1277.           Some computers do not support concurrent disk and serial I/O at high
  1278.           speeds.  The handshake slow command drops the RTS signal to the
  1279.           modem during disk writes when receiving files with YMODEM-g or
  1280.           ZMODEM.  The handshake slow command does not correct overrun
  1281.           problems caused by TSRs and multitasking executives.
  1282.  
  1283.           The handshake both command allows either CTS or XOFF to pause
  1284.           output, in addition to asserting input flow control with the RTS
  1285.           output.  This is useful when the local modem uses CTS/RTS hardware
  1286.  
  1287.  
  1288.         __________
  1289.  
  1290.         10. ZCOMM automatically disables its software (XON/XOFF) flow control
  1291.             when using XMODEM, YMODEM and similar protocols that require all
  1292.             256 byte codes.  These protocols may not work if the modem is set
  1293.             for software flow control.
  1294.  
  1295.  
  1296.  
  1297.         (C) 1990 Omen Tech Inc                        Chapter 19 Main Commands
  1298.  
  1299.  
  1300.         Version 17.78 TurboDial 2.35            Universal Line Printer Edition
  1301.         ZCOMM User Manual                                                  113
  1302.  
  1303.           flow control, but calls a network such as CompuServe, Telenet, or
  1304.           Tymnet that uses software (XON/XOFF) flow control.
  1305.  
  1306.           The handshake dcd command enables d mode (q.v.).  Subsequently,
  1307.           selecting a different type of handshaking will disable d mode.  Use
  1308.           of handshake dcd is not recommended.
  1309.  
  1310.           The "handshake off" command disables all flow control except for
  1311.           XOFF characters sent by the term function.
  1312.  
  1313.           The handshake command (without argument) releases flow control
  1314.           (allows data to flow if it had been stopped by handshaking).
  1315.  
  1316.           Changing the communications port with the port or portx command
  1317.           disables hardware handshaking.
  1318.  
  1319.           Operation of the handshake command varies with the operating system
  1320.           and hardware used.
  1321.  
  1322.  
  1323.           SEE ALSO: S numeric parameter
  1324.  
  1325.           EXAMPLE: handshake cts Turns on CTS handshaking.
  1326.  
  1327.  
  1328.         help The help command uses the helpfile or xhelpfile string parameter
  1329.           depending on whether ZCOMM is in host operation.  Normally, the help
  1330.           command displays a command summary, pausing every 24 lines.
  1331.  
  1332.           If the string parameter begins with the character @, ZCOMM uses the
  1333.           rest of the parameter as the initial command to access a pop-up help
  1334.           program.  The contents of the f string parameter are added to this
  1335.           command, separated by a space.  Thus, if helpfile contains "@yhp
  1336.           /umanh.hlp", giving the help command from the main prompt executes
  1337.           the DOS command "yhp /umanh.hlp main".
  1338.  
  1339.           If the called program leaves a file yamhelp.tmp containing script
  1340.           commands in the current directory, ZCOMM executes this file with a
  1341.           source command and then deletes it.
  1342.  
  1343.           SEE ALSO: f, helpfile, xhelpfile string parameters, source command
  1344.  
  1345.         history [histfile] Opens histfile for use as a dual 64 entry history
  1346.           file for commands entered both at the ZCOMM command prompt and
  1347.           online with the term function.  Histfile is a random access file
  1348.           used as a pair of circular buffers to save commands for recall.
  1349.           Only a file created by a previous history command may be used with
  1350.           the history command.  If the specified histfile does not exist, it
  1351.           is created.  Histfile stores commands with T or more characters
  1352.           where T is the value of the T numeric parameter.
  1353.  
  1354.  
  1355.  
  1356.         (C) 1990 Omen Tech Inc                        Chapter 19 Main Commands
  1357.  
  1358.  
  1359.         Version 17.78 TurboDial 2.35            Universal Line Printer Edition
  1360.         ZCOMM User Manual                                                  114
  1361.  
  1362.           If histfile is not specified with the history command, the current
  1363.           history file is updated and closed.
  1364.  
  1365.           The history command may be given with a different file name whenever
  1366.           desired to access useful commands saved from previous sessions with
  1367.           a particular host or application.
  1368.  
  1369.           When history is enabled, the Up and Down function keys scroll
  1370.           through previously entered commands.  Ctrl-P and Ctrl-N may be used
  1371.           in place of Up and Down respectively.  An old command so selected
  1372.           may be edited with editing keys described in Chapter 18 and executed
  1373.           with the <ENTER> key.
  1374.  
  1375.           In the term function, the history accessed with the Up and Down keys
  1376.           is displayed and edited in the status line. [11] A Ctrl-X clears the
  1377.           recalled text and restores normal status line and keyboard
  1378.           operation.
  1379.  
  1380.           EXAMPLE: history /tmp/favbbs.hist
  1381.  
  1382.  
  1383.           SEE ALSO: r command, T numeric parameter
  1384.           N.B.: Do not give the history command before you have entered any
  1385.           secret passwords from the keyboard as these will be saved in the
  1386.           history file.  The history command without an argument closes the
  1387.           history file and disables command recall.  Alternatively, the T
  1388.           numeric parameter may be set to a large value to inhibit storing of
  1389.           passwords in histfile.
  1390.  
  1391.           Normally, histfile should be an absolute pathname to insure that the
  1392.           same file will be used regardless of the directory from which ZCOMM
  1393.           is called from.
  1394.  
  1395.           The history command is not available when Restricted.
  1396.           N.B.: Do not attempt to delete an open file on DOS, especially the
  1397.           history file.
  1398.  
  1399.         host The host command conditions ZCOMM to accept incoming calls
  1400.           unattended.  Host operation is described in Chapter 28.  The EXIT
  1401.           key F1 terminates Host Operation.
  1402.           N.B.: The host command is normally given only by a script that sets
  1403.           parameters to their appropriate values.  Use the "host" entry in the
  1404.           distributed PHODIR.t file as a prototype for your application.
  1405.  
  1406.           SEE ALSO: remote command
  1407.  
  1408.  
  1409.         __________
  1410.  
  1411.         11. Unix/Xenix flavors only support Backspace editing in this mode.
  1412.  
  1413.  
  1414.  
  1415.         (C) 1990 Omen Tech Inc                        Chapter 19 Main Commands
  1416.  
  1417.  
  1418.         Version 17.78 TurboDial 2.35            Universal Line Printer Edition
  1419.         ZCOMM User Manual                                                  115
  1420.  
  1421.         if condition command ... The if command provides powerful condition
  1422.           testing for scripts.  If executes the command(s) on the rest of the
  1423.           line if condition is true.  Otherwise, execution continues
  1424.           immediately with the next script line.  Chapter 27 describes the
  1425.           testable conditions.
  1426.  
  1427.           SEE ALSO: else, on commands
  1428.  
  1429.         ife condition cmd1 ...; cmd2 ... Execute cmd1 ...  if condition is
  1430.           true; otherwise skip to the first semicolon in the rest of the line
  1431.           and resume execution (unconditionally) with cmd2.  Iff a semicolon
  1432.           is not present, execution resumes at the end of the line, useful
  1433.           within the body of a while command.
  1434.  
  1435.           EXAMPLE: set f5
  1436.           @ife %s1 echo "s1 =%s1";  else echo "s1 not set"
  1437.  
  1438.           (Without the "else", the right half will always execute.)
  1439.  
  1440.  
  1441.         kbdlock N * Controls acceptance of keyboarded characters by the term
  1442.           function and during protocol file transfers.  If N is non zero, the
  1443.           term function does not act upon key strokes.  If N is greater than
  1444.           1, key strokes have no effect on protocol transfers.  The Ctrl-Break
  1445.           key and the command prompt reset kbdlock to 0.  If N is 257, the
  1446.           Ctrl-Break key does not reset Kbdlock.  Kbdlock does not affect the
  1447.           k test condition or the accept command.  Characters typed while
  1448.           kbdlock is on will become available at the next command prompt,
  1449.           accept command, or when kbdlock is reset unless typeahead is purged
  1450.           with the purgek command.
  1451.  
  1452.           SEE ALSO: purgek command, Ctrl-Break key
  1453.  
  1454.         kbdmon [file] captures keystrokes to file.  If file exists, it is
  1455.           appended to.  Function keys are denoted by an 0xFF character
  1456.           followed by the code returned by the BIOS.  The kbdmon command
  1457.           without an argument closes the file.  This command is not available
  1458.           when Restricted.
  1459.  
  1460.         kermit By itself, selects Kermit or Kermit related parameters for use
  1461.           by the !!, p, rb, and sb commands.
  1462.  
  1463.         Kermit rb [-options] Kermit rb receives files using the Kermit file
  1464.           transfer protocol.  Chapter 20 describes the available options.
  1465.           File names are given by the sending program.  The Kermit programs
  1466.           must have compatible parity settings as described in Chapter 13,
  1467.           Kermit Protocol.
  1468.  
  1469.           Kermit rb receives files from a regular Kermit program; use the get
  1470.           command to receive files from a Kermit server.
  1471.  
  1472.  
  1473.  
  1474.         (C) 1990 Omen Tech Inc                        Chapter 19 Main Commands
  1475.  
  1476.  
  1477.         Version 17.78 TurboDial 2.35            Universal Line Printer Edition
  1478.         ZCOMM User Manual                                                  116
  1479.  
  1480.           EXAMPLE: kermit pi1;  kermit rb Downloads files from an IBM
  1481.           mainframe.
  1482.  
  1483.  
  1484.           ZCOMM's term function will sense the remote Kermit's parity setting
  1485.           and download files without user intervention When the remote Kermit
  1486.           starts sending, if K (Kermit autodownload) mode is enabled (the
  1487.           default).
  1488.  
  1489.         Kermit sb [-options] pathspec Kermit sb sends the specified files to
  1490.           either a regular Kermit program or a Kermit server.  Chapter 20
  1491.           describes the available options.  The Kermit programs must have
  1492.           compatible parity settings as described in Chapter 13, Kermit
  1493.           Protocol.
  1494.  
  1495.           EXAMPLE: kermit pi1;  kermit sb file ...  Sends the specified files
  1496.           to an IBM mainframe.
  1497.  
  1498.  
  1499.         keys, ALT-K Keys displays the definitions the user has assigned to the
  1500.           function keys.
  1501.  
  1502.         ki Clears the y0...y127 string parameters and causes circular buffer
  1503.           writing operations to ignore data from the remote which has already
  1504.           been displayed.  This data is still available to the review
  1505.           function.
  1506.  
  1507.  
  1508.           EXAMPLE: The script fragment
  1509.  
  1510.               pat 1c "///BEGIN///"   "@ki create -+ print.fil"
  1511.               pat 2c "///END///"   "@close"
  1512.               wait -f30000
  1513.  
  1514.           will capture the data that arrives between "///BEGIN///" and the end
  1515.           of the string "///END///".  Other data from the remote will not be
  1516.           captured to disk.  The long pattern match fail time (30000 seconds)
  1517.           makes the the cycle repeat almost indefinitely.
  1518.  
  1519.  
  1520.           SEE ALSO: W mode
  1521.  
  1522.         kill Erases (flushes) all data stored in the circular buffer and
  1523.           restores the buffer pointers to their initial positions.
  1524.  
  1525.         kill [-signum] procnum Available on Unix and OS/2 flavors, this form
  1526.           of the kill command supports interprocess communications.  If signum
  1527.           is absent, the kill command checks for the existence of the
  1528.           specified process, but does not send it a signal.  Success sets the
  1529.           ?  numeric parameter to 0, otherwise -1.
  1530.  
  1531.  
  1532.  
  1533.         (C) 1990 Omen Tech Inc                        Chapter 19 Main Commands
  1534.  
  1535.  
  1536.         Version 17.78 TurboDial 2.35            Universal Line Printer Edition
  1537.         ZCOMM User Manual                                                  117
  1538.  
  1539.           SEE ALSO: createx command, Unix kill(1)
  1540.  
  1541.         l, ll, ls, lx For Unix users, synonyms for the dir commands.
  1542.  
  1543.         learn lfile TurboLearn(TM) Script Writer records timing information
  1544.           and term function keystrokes to lfile.  The TurboLearn program
  1545.           tlearn.exe then generates a script using this data.  Normally,
  1546.           learning is initiated after the connection has been established, but
  1547.           before the first prompt is received from the remote.  This is best
  1548.           accomplished with the F4 key, which activates the tlearn telephone
  1549.           directory entry.
  1550.  
  1551.           Function keys, cursor keys, reassigned keys, and scripts[12] should
  1552.           not be used while learning.
  1553.  
  1554.           When accepting passwords and other sensitive information, systems
  1555.           sometimes acknowledge each keyboard character with #, *, x, or X,
  1556.           instead of the keyboarded character itself.  When this happens, do
  1557.           not type characters faster than the remote responds to them.
  1558.  
  1559.           The resulting script should be examined for evidence of keyboarding
  1560.           mistakes, line noise, and dependence on prompts that change each
  1561.           time you access the system.
  1562.  
  1563.           The comments below apply when the tlearn script is not used.
  1564.  
  1565.           EXAMPLE: kill
  1566.                123-4567; learn lfile
  1567.  
  1568.           From the ZCOMM main command prompt, enter the desired phone number.
  1569.           When ZCOMM connects, the learn command enters the term function with
  1570.           learning (recording) turned on.
  1571.  
  1572.                <keyboard the operations you wish recorded>
  1573.  
  1574.           Login to the bulletin board as usual.  If you make keyboarding
  1575.           mistakes, you can edit the script file later.
  1576.  
  1577.                ALT-C F1
  1578.  
  1579.           Terminate learning with ALT-C, and return to the main command prompt
  1580.           with the F1 key.
  1581.  
  1582.                !tlearn lfile >newscript
  1583.  
  1584.  
  1585.  
  1586.         __________
  1587.  
  1588.         12. Other than the dialing script
  1589.  
  1590.  
  1591.  
  1592.         (C) 1990 Omen Tech Inc                        Chapter 19 Main Commands
  1593.  
  1594.  
  1595.         Version 17.78 TurboDial 2.35            Universal Line Printer Edition
  1596.         ZCOMM User Manual                                                  118
  1597.  
  1598.           From the main command prompt, execute the TurboLearn program tlearn
  1599.           with a DOS Gateway.
  1600.  
  1601.  
  1602.           After recording, the tlearn program reads lfile and generates a
  1603.           series of pattern and put script commands to let ZCOMM search for
  1604.           the prompts and respond with the proper keystrokes.  The resulting
  1605.           script file newscript may be accessed with the source command.
  1606.  
  1607.           Alternatively, the last command above may be replaced with
  1608.  
  1609.                !tlearn -d newdirname lfile >>phones.t
  1610.  
  1611.           to add the new script to the end of your telephone directory.
  1612.  
  1613.           The -d dirname causes tlearn to prepend the given new directory
  1614.           entry name newdirname and the telephone number to the resulting
  1615.           script commands.  The redirection characters >> add the script
  1616.           commands to the end of your telephone directory.
  1617.  
  1618.           You can also use the -d newdirname option to tlearn to prepare a new
  1619.           directory entry in a separate file.  Then you can edit this file and
  1620.           add it somewhere within your telephone directory.
  1621.  
  1622.           The tlearn program also accepts a -r option to suppress a "return"
  1623.           command normally emitted at the end of the generated script.  This
  1624.           tlearn option allows one to append an "off" command to the generated
  1625.           script.
  1626.  
  1627.         link * Link two serial ports.  The link command allows remote access
  1628.           to a computer or other device connected to another port.  For
  1629.           example, if port 1 is connected to an autoanswer modem and port 2 is
  1630.           connected to a local timesharing machine, the link command would
  1631.           allow dial-up callers access to the timesharing machine.  Chapter
  1632.           19.5 describes the link command.
  1633.  
  1634.         list pathspec The list command uses standard DOS character output
  1635.           routines and any installed CRT device driver instead of ZCOMM's own
  1636.           CRT driver.  The printer can be enabled with ^P given to DOS (not
  1637.           ZCOMM).  List the specified file(s).
  1638.  
  1639.           This command closes any open transmit file.  ZCOMM detects SQueezed
  1640.           files and prints them in ASCII.* List pauses/resumes printing with
  1641.           ^S.  Keyboarding ^C cancels, and ^X skips to the next file (it might
  1642.           take a few whacks of the keyboard to get ZCOMM to hear it.) The list
  1643.           command defaults to a type command when ZCOMM is in host operation.
  1644.  
  1645.           EXAMPLE: list *.cq
  1646.  
  1647.  
  1648.           SEE ALSO: browse, type, page commands
  1649.  
  1650.  
  1651.         (C) 1990 Omen Tech Inc                        Chapter 19 Main Commands
  1652.  
  1653.  
  1654.         Version 17.78 TurboDial 2.35            Universal Line Printer Edition
  1655.         ZCOMM User Manual                                                  119
  1656.  
  1657.         lput string Displays string on the console display.  String is
  1658.           processed for character escapes.  Lput is useful for scripts sending
  1659.           cursor control codes to the screen.  Control characters and escape
  1660.           sequences used with the lput command are always decoded with ZCOMM's
  1661.           default extended VT52/Z19 emulation, which also recognizes ANSI "ESC
  1662.           [" sequences, regardless of which display emulation is selected.
  1663.           Unlike the echo command, lput does not display in reverse video and
  1664.           does not add a carriage return/linefeed to its argument.
  1665.  
  1666.           SEE ALSO: echo command
  1667.  
  1668.         lputp string Outputs string to the line printer.  String is processed
  1669.           for character escapes.  Strings with embedded nulls (represented
  1670.           with the \000 character escape) may be used.  The lput command
  1671.           should not be used if the printer is jammed, out of paper, or off
  1672.           line.  These conditions may be tested with the l test condition.
  1673.           This command is not allowed when ZCOMM is Restricted.
  1674.  
  1675.           EXAMPLE: if l lputp "\E\017" If the printer is ready, ZCOMM sends
  1676.           ESC SI to select compressed printing on an IBM 80 CPS printer.
  1677.  
  1678.  
  1679.           SEE ALSO: l numeric parameter, l test condition, \dNNN (decimal)
  1680.           character escapes
  1681.  
  1682.         menu Execute script commands from the file name stored in the string
  1683.           parameter menu.
  1684.  
  1685.         message The message command allows a caller to keyboard a message
  1686.           which will be appended to a file specified by the string parameter
  1687.           messages.  Typically, messages would point to a publicly visible
  1688.           file to allow other callers to read messages.  The message command
  1689.           is otherwise identical to the private command.
  1690.  
  1691.           SEE ALSO: private command
  1692.  
  1693.         mk [scancode shiftstate class string] Assign term function keyboard
  1694.           mapping.  Without an argument, mk resets and disables keyboard
  1695.           mapping.  The mk command is described in Chapter 29.
  1696.  
  1697.           SEE ALSO: N numeric parameter, _ command
  1698.  
  1699.         more pathspec See page command.
  1700.  
  1701.         mput string The mput command transmits string to the remote at full
  1702.           speed.  String is processed for character escapes.  Unlike the put
  1703.           and putw commands, mput does not display characters coming from the
  1704.           remote (they are held in the interrupt buffer).  Control and other
  1705.           special characters may be entered with character escapes.  If a
  1706.           carriage return should be sent, it must be explicitly coded with \r
  1707.           at the end of the string.
  1708.  
  1709.  
  1710.         (C) 1990 Omen Tech Inc                        Chapter 19 Main Commands
  1711.  
  1712.  
  1713.         Version 17.78 TurboDial 2.35            Universal Line Printer Edition
  1714.         ZCOMM User Manual                                                  120
  1715.  
  1716.           SEE ALSO: put, putw commands
  1717.  
  1718.         nolog * Suppress generation of the next log entry (of any kind).
  1719.  
  1720.           EXAMPLE: mysys     nolog speed 1200 123-4567 t
  1721.           Suppresses the log entry that would otherwise be made if the calllog
  1722.           string parameter is set.
  1723.  
  1724.  
  1725.         nulls n When accessing ZCOMM in host operation, nulls sets the number
  1726.           of nulls (default 0) sent after each linefeed to allow slow
  1727.           terminals time to scroll.
  1728.  
  1729.           EXAMPLE: nulls 4
  1730.  
  1731.  
  1732.         o Terminates a data call by dropping DTR (Data Terminal Ready).  DOS
  1733.           ZCOMM drops Clear To Send (CTS) as well as DTR if hardware flow
  1734.           control was selected with the handshake command.  A bye or speed n
  1735.           command must be given to reassert DTR before making or answering
  1736.           another data call.[13] The o command does not release ownership of
  1737.           the serial port.
  1738.  
  1739.           SEE ALSO: speed, bye, off, port commands
  1740.  
  1741.         obey string Sometimes one wishes to execute the contents of a string
  1742.           parameter as a ZCOMM command.  Other times one needs to reference a
  1743.           pathname stored in a string parameter in the context of a command
  1744.           that does not itself perform string substitution on its argument(s).
  1745.  
  1746.           Obey executes string as a ZCOMM command.  Character escapes in
  1747.           string are substituted before execution.
  1748.  
  1749.           EXAMPLE: obey ">>%s0" Redirects the output of utility commands to
  1750.           the pathname stored in string parameter s0.
  1751.  
  1752.  
  1753.           EXAMPLE: pat 19c "OBEY-LAST" "@obey %y2" Sets pattern 19 to execute
  1754.           the previous line received from the remote when the string "OBEY-
  1755.           LAST" is received.
  1756.  
  1757.           N.B.: The remainder of the line after the obey command will be
  1758.           executed unless execution of string is terminated by a return or
  1759.           fail command.  The construction obey "if xxx goto foo" May be used
  1760.           only if no commands follow the obey command's string argument.
  1761.  
  1762.  
  1763.         __________
  1764.  
  1765.         13. Most telephone directory entries include a speed command.
  1766.  
  1767.  
  1768.  
  1769.         (C) 1990 Omen Tech Inc                        Chapter 19 Main Commands
  1770.  
  1771.